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NAME 

"IO::Async::LoopTests" - acceptance testing for IO::Async::Loop subclasses 

SYNOPSIS 

use 10::Async::LoopTests; 

run_tests( '10::Async::Loop::Shiney', 'io' ) ; 

DESCRIPTION 

This module contains a collection of test functions for running acceptance tests on IO::Async::Loop 
subclasses. It is provided as a facility for authors of such subclasses to ensure that the code conforms to the 
Loop API required by IO::Async. 

TIMING 

Certain tests require the use of timers or timed delays. Normally these are counted in units of seconds. By 
setting the environment variable TEST_QUICK_TIMERS to some true value, these timers run 10 times 
quicker, being measured in units of 0.1 seconds instead. This value may be useful when running the tests 
interactively, to avoid them taking too long. The slower timers are preferred on automated smoke-testing 
machines, to help guard against false negatives reported simply because of scheduling delays or high 
system load while testing. 

TEST_QUICK_TIMERS=1 ./Build test 

FUNCTIONS 

ruii_tests 

run_tests( $class, @tests ) 

Runs a test or collection of tests against the loop subclass given. The class being tested is loaded by this 
function; the containing script does not need to require or use it first. 

This function runs Test: :More: :plan to output its expected test count; the containing script should 
not do this. 

TEST SUITES 

The following test suite names exist, to be passed as a name in the @tests argument to run_tests: 

io 

Tests the Loop’s ability to watch filehandles for IO readiness 

timer 

Tests the Loop’s ability to handle timer events 

signal 

Tests the Loop’s ability to watch POSIX signals 

idle 

Tests the Loop’s support for idle handlers 

child 

Tests the Loop’s support for watching child processes by PID 

control 

Tests that the run, stop, loop_once and loop_f orever methods behave correctly 
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